// Foundation for Sites by ZURB
// foundation.zurb.com
// Licensed under MIT Open Source

////
/// @group breakpoints
////

/// 命名断点列表。您可以将它们与 `breakpoint()` mixin 一起使用来快速创建媒体查询
/// @type Map
$breakpoints: (
  small: 0,
  medium: 640px,
  large: 1024px,
  xlarge: 1200px,
  xxlarge: 1440px,
) !default;

/// 包含 print 作为媒体类型的最大命名断点
/// @type Keyword
$print-breakpoint: large !default;

$-zf-zero-breakpoint: small !default;

$-zf-breakpoints-keys: map-to-list($breakpoints, 'keys');

@if nth(map-values($breakpoints), 1) != 0 {
  @error 'The first key in the $breakpoints map must have a value of "0".';
} @else {
  $-zf-zero-breakpoint: nth(map-keys($breakpoints), 1);
}

/// 此列表中的所有名称将作为 CSS 中的类输出，如`.small-12`，`.medium-6`，依此类推。此列表中的每个值也必须位于 `$breakpoints` Map 中。
/// @type List
$breakpoint-classes: (small medium large) !default;

/// 生成与输入值匹配的媒体查询字符串。请参阅 `breakpoint()` mixin 的文档，看看可能的输入是什么。
///
/// @param {Keyword|Number} $val [small] - 要处理的断点名称或 px，rem 或 em 值。
@function breakpoint($val: $-zf-zero-breakpoint) {
  // 大小或关键字
  $bp: nth($val, 1);
  // 最大宽度媒体查询
  $bp-max: 0;
  // 媒体查询的方向 (up, down, 或 only)
  $dir: if(length($val) > 1, nth($val, 2), up);
  // 最终输出
  $str: '';
  // 他是一个命名的媒体查询？
  $named: false;

  // 定向媒体查询具有特殊的语法（用于移动端）
  @if $bp == 'landscape' or $bp == 'portrait' {
    // 横屏和竖屏
    @return '(orientation: #{$bp})';
  } @else if $bp == 'retina' {
    // Retina 显示器
    @return '(-webkit-min-device-pixel-ratio: 2), (min-resolution: 192dpi)';
  }

  // 尝试从 $breakpoints Map 中提取命名断点
  @if type-of($bp) == 'string' {
    // 如果存在命名断点
    @if map-has-key($breakpoints, $bp) {
      // 如果方向是 `only` 或 `down` 最大断点取下一个命名断点值
      @if $dir == 'only' or $dir == 'down' {
        $bp-max: -zf-map-next($breakpoints, $bp);
      }

      $bp: map-get($breakpoints, $bp);
      $named: true;
    } @else {
      $bp: 0;
      @warn 'breakpoint(): "#{$val}" is not defined in your $breakpoints setting.';
    }
  }

  // 将像素, rem 或无单位的值转换为 em
  $bp: -zf-bp-to-em($bp);

  // 下一个断点下的最大值为0.2px（0.02 / 16 = 0.00125）。
  // 使用 1px 以下的精度来支持浏览器缩放，但不能低到以避免舍入。
  // See https://github.com/zurb/foundation-sites/issues/11313
  @if $bp-max {
    $bp-max: -zf-bp-to-em($bp-max) - .00125;
  }

  // 跳过媒体查询创建的条件
  // - 这是一个命名断点，解析为“0 down”或“0 up”
  // - 它是一个数字断点，解析为“0” + 任何东西
  @if $bp > 0em or $dir == 'only' or $dir == 'down' {
    // `only` 范围使用格式 `(min-width: n) and (max-width: n)`
    @if $dir == 'only' {
      // 只有命名媒体查询才有 `only` 范围
      @if $named == true {
        // 如果下舍入大于0，则仅使用“min-width”
        @if $bp > 0em {
          $str: $str + '(min-width: #{$bp})';

          // 如果存在上限，则仅向媒体查询添加“and”
          @if $bp-max != null {
            $str: $str + ' and ';
          }
        }

        // 如果有向上舍入，只能使用“max-width”
        @if $bp-max != null {
          $str: $str + '(max-width: #{$bp-max})';
        }
      } @else {
        @warn 'breakpoint(): Only named media queries can have an `only` range.';
      }
    }

      // `down`范围使用格式`(max-width：n)`
    @else if $dir == 'down' {
      $max: if($named, $bp-max, $bp);

      // 如果输入值正好为“0 down”，则跳过媒体查询创建
      // 除非该函数被称为“小向下”，在这种情况下它只是“small only”
      @if $named or $bp > 0em {
        @if $max != null {
          $str: $str + '(max-width: #{$max})';
        }
      }
    }

      // `up` 范围使用格式 `(max-width：n)`
    @else if $bp > 0em {
      $str: $str + '(min-width: #{$bp})';
    }
  }

  @return $str;
}

/// 围绕放在mixin中的内容包装媒体查询。这个mixin接受了许多值：
///  - 如果传递了一个字符串，mixin 将在 `$breakpoints` Map 中查找它，并在那里使用媒体查询
///  - 如果传递了一个像素值，它将使用 `$global-font-size` 作为基础转换为 em 值
///  - 如果传递了 rem 值，则该单位将更改为em
///  - 如果传递了 em 值，则该值将按原样使用
///
/// @param {Keyword|Number} $value - 要处理的断点名称或 px，rem 或 em 值
///
/// @output 如果断点是“0px和更大”，则按原样输出内容。否则，输出媒体查询中包含的内容
@mixin breakpoint($value) {
  $str: breakpoint($value);
  $bp: index($-zf-breakpoints-keys, $value); // 断点
  $pbp: index($-zf-breakpoints-keys, $print-breakpoint); // 打印断点

  $old-zf-size: null;

  // 让断点大小作为一个可用变量
  @if global-variable-exists(-zf-size) {
    $old-zf-size: $-zf-size;
  }
  $-zf-size: nth($value, 1) !global; // get the first value to account for `only` and `down` keywords

  // 如果 $str 仍为空字符串，不需要媒体查询
  @if $str == '' {
    @content;
  }

    // 否则，将内容包装在媒体查询中
  @else {
    // 对于小于或等于 $print-breakpoint 的命名断点，请将 print 添加到媒体类型
    @if $bp != null and $bp <= $pbp {
      @media print, screen and #{$str} {
        @content;
      }
    } @else {
      @media screen and #{$str} {
        @content;
      }
    }
  }

  $-zf-size: $old-zf-size !global;
}

/// 将断点 Map 转换为 URL 编码的字符串，如下所示：`key1=value1&key2=value2`。然后将该值放入 CSS 中以获取特殊的 `<meta>` 标记，该标记由 Foundation JavaScript 读取。这是我们将值从 Sass 传递到 JavaScript 的方式，因此可以在一个地方定义它们。
/// @access private
///
/// @param {Map} $map - 需要转换的 Map
///
/// @returns {String} 包含 Map 内容的字符串
@function -zf-bp-serialize($map) {
  $str: '';
  @each $key, $value in $map {
    $str: $str + $key + '=' + -zf-bp-to-em($value) + '&';
  }
  $str: str-slice($str, 1, -2);

  @return $str;
}

/// 在 Map 中查找下一个键
/// @access private
///
/// @param {Map} $map - 便利的 Map
/// @param {Mixed} $key - 开始键
///
/// @returns {Mixed} 如果找得到 `$key` 则返回它的值，如果找不到或者为最后一个将返回 `null`
@function -zf-map-next($map, $key) {

  // 将 Map 中的键存储为一个列表
  $values: map-keys($map);

  $i: 0;

  // 如果键存在，索引为当前索引的下一个索引
  @if (map-has-key($map, $key)) {
    $i: index($values, $key) + 1;
  }

  // 如果索引超出 Map 长度或不存在索引返回 null
  @if ($i > length($map) or $i == 0) {
    @return null;
  }
    // 否则，返回相应值
  @else {
    @return map-get($map, nth($values, $i));
  }

}

/// 返回小于指定键的命名断点列表。用于处理响应式网格的间距
/// @access private
///
/// @param {String} $key - 用于最后一个断点的键名
///
/// @returns {Array} 返回多个断点的列表。如果 $key 为 auto, 返回大于0的断点
@function -zf-breakpoints-less-than($key) {
  $list: ();
  $found_key: false;

  @each $name in $-zf-breakpoints-keys {
    @if ($name == $key) {
      $found_key: true;
    }
    @if not $found_key {
      $list: append($list, $name);
    }
  }
  @return $list;
}

/// 返回小于指定键的命名断点列表。用于处理响应式网格的间距
/// @access private
///
/// @param {String} $breakpoint -命名或非命名断点
///
/// @returns {Array} 返回多个断点的列表。如果 $key 为 auto, 返回大于0的断点
@function -zf-closest-named-breakpoint($breakpoint) {
  $last: $-zf-zero-breakpoint;
  $found: false;

  $value: unitless-calc($breakpoint, 1px);
  @each $key, $val in $breakpoints {
    @if not $found {
      @if unitless-calc($val) > $value {
        $found: true;
      } @else {
        $last: $key;
      }
    }
  }

  @return $last;
}

/// 从响应式配置 Map 或单个值中获取断点的值
/// - 如果配置是单个值，则返回它而不管`$value`
/// - 如果配置是一个 Map 并且键为'$value`，则返回明确的断点值
/// - 如果配置是 Map 并且*不*具有断点，则返回与配置 Map 中的下一个最低断点匹配的值
/// @access private
///
/// @param {Number|Map} $map - 相应式配置 Map 或单个值
/// @param {Keyword} $value - 使用的断点名称
///
/// @return {Mixed} 相应的断点值
@function -zf-get-bp-val($map, $value) {
  // 如果传递的 Map 是单个值，照原样返回
  @if type-of($map) == 'number' {
    @return $map;
  }

  // 检查断点名称在全局中是否存在
  @if not map-has-key($breakpoints, $value) {
    @if type-of($value) == 'number' {
      $value: -zf-closest-named-breakpoint($value);
    } @else {
      @return null;
    }
  }
    // 检查断点名称在本地配置中是否存在
  @else if map-has-key($map, $value) {
    // 如果存在返回它
    @return map-get($map, $value);
  }
    // 否则，找到下一个最低断点名称，并返回它的值
  @else {
    $anchor: null;
    $found: false;

    @each $key, $val in $breakpoints {
      @if not $found {
        @if map-has-key($map, $key) {
          $anchor: $key;
        }
        @if $key == $value {
          $found: true;
        }
      }
    }

    @return map-get($map, $anchor);
  }
}

// 一系列快捷变量

$small-up: '';
$small-only: '';

@if map-has-key($breakpoints, small) {
  $small-up: screen;
  $small-only: unquote('screen and #{breakpoint(small only)}');
}

$medium-up: '';
$medium-only: '';

@if map-has-key($breakpoints, medium) {
  $medium-up: unquote('screen and #{breakpoint(medium)}');
  $medium-only: unquote('screen and #{breakpoint(medium only)}');
}

$large-up: '';
$large-only: '';

@if map-has-key($breakpoints, large) {
  $large-up: unquote('screen and #{breakpoint(large)}');
  $large-only: unquote('screen and #{breakpoint(large only)}');
}

$xlarge-up: '';
$xlarge-only: '';

@if map-has-key($breakpoints, xlarge) {
  $xlarge-up: unquote('screen and #{breakpoint(xlarge)}');
  $xlarge-only: unquote('screen and #{breakpoint(xlarge only)}');
}

$xxlarge-up: '';

@if map-has-key($breakpoints, xxlarge) {
  $xxlarge-up: unquote('screen and #{breakpoint(xxlarge)}');
}
